home *** CD-ROM | disk | FTP | other *** search
/ EuroCD 3 / EuroCD 3.iso / Programming / Python-1.4 / Demo / scripts / newslist.doc < prev    next >
Encoding:
Text File  |  1998-06-24  |  2.4 KB  |  60 lines
  1.                              NEWSLIST
  2.                              ========    
  3.             A program to assist HTTP browsing of newsgroups
  4.             ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  5.  
  6. WWW browsers such as NCSA Mosaic allow the user to read newsgroup
  7. articles by specifying the group name in a URL eg 'news:comp.answers'.
  8.  
  9. To browse through many groups, though, (and there are several thousand
  10. of them) you really need a page or pages containing links to all the
  11. groups. There are some good ones out there, for example,
  12.  
  13.     http://info.cern.ch/hypertext/DataSources/News/Groups/Overview.html
  14.  
  15. is the standard one at CERN, but it only shows the groups available there,
  16. which may be rather different from those available on your machine.
  17.  
  18. Newslist is a program which creates a hierarchy of pages for you based
  19. on the groups available from YOUR server. It is written in python - a
  20. splendid interpreted object-oriented language which I suggest you get
  21. right now from the directory /pub/python at ftp.cwi.nl, if you haven't
  22. already got it.
  23.  
  24. You should be able to see some sample output by looking at:
  25.    http://pelican.cl.cam.ac.uk/newspage/root.html
  26.  
  27. Descriptions of newsgroups can be added from a file with one group
  28. per line. eg:
  29.  
  30.     alt.foo   Articles about foo
  31.     comp.bar  Programming in 'bar' and related languages
  32.  
  33. A suitable list detailing most groups can be found at ftp.uu.net in
  34. /uunet-info/newsgroups.gz.
  35.  
  36. Make sure you read the information at the beginning of the program source and
  37. configure the variables before running.
  38.  
  39. In addition to python, you need:
  40.  
  41.     An NNTP-based news feed.
  42.     A directory in which to put the pages.
  43.  
  44. The programming is not very beautiful, but it works!  It comes with no
  45. warranty, express or implied, but with the hope that some others may
  46. find it useful.
  47.  
  48. Comments, improvements & suggestions welcomed.
  49. Quentin Stafford-Fraser
  50.  
  51.  ----------------------------------------------------------------------
  52.                        Quentin Stafford-Fraser
  53.             http://pelican.cl.cam.ac.uk/people/qs101/me.html
  54.  
  55.  Cambridge University Computer Lab        Rank Xerox Cambridge EuroPARC
  56.  qs101@cl.cam.ac.uk                           fraser@europarc.xerox.com
  57.  Tel: +44 223 334411                                Tel: +44 223 341521
  58.  Fax: +44 223 334679                                Fax: +44 223 341510
  59.  ----------------------------------------------------------------------
  60.